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GATEWAY CONTROL SOFTWARE 


RS—-RP2C 


Set Up Instructions 


IMPORTANT 


READ THIS INSTRUCTION MANUAL 
CAREFULLY before attempting to operate the re- 
peater. 
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m@ System requirements 


PREPARATION 1 


The following units and/or environments are required 
to build D-STAR gateway server. 


& PC 
°OS : Linux® (updated) 
Compatible distribution: 
Fedora Core 2 or RedHat® Linux® 9 
Compatible software version 
Linux® Kernel 2.4.20 or later 
glibc 2.3.2 or later 
BIND 9.2.1 or later 
*CPU : Pentium® grade 2.4 GHz or faster 


Memory : At least 512 MB 
LAN board: 2 (NIC from Intel® is recommended) 
*HDD : At least 10 GB of free space (incl. OS 


installation) 


Internet line 

eLine speed : 750 kbps or more (recommended effec- 
tive speed*) for both uplink/downlink 
*Ask the ISP for effective speed. 


© Fixed IP address 
eApply to the ISP to acquire a fixed global IP address. 


© Router 
Following functions are required for the router. 
Remote access function (the port forward, DMZ etc.) 
Capability of setting a fixed IP address, such as 
PPPoE for WAN 
¢NAT/IP masquerade 
¢ Static IP masquerade/DMZ 
eIP filtering function 
¢DNS answering function 
¢Static DHCP server setting for LAN 
¢Class A subnet mask (255.0.0.0) can be set for LAN 
(For your information: The router, WRV54G from 
LINKSYS, covers all the requirements as above.) 
*Ask the ISP for recommended router model. 


@ Linux® down loading 


4 NOTE: If you have Linux OS CD (specified distribu- 
Y tion and software version), skip this instruction and 
% refer to “MLinux® OS installation” (p. 2). 


The following hardware and software are required for 
Linux® OS down loading. 


¢ Another PC 
The PC must be connected to internet. 
°CD-R drive 
°CD writing software 
The software have capability to burning 
a CD with an ISO image. 


© Down loading the OS 

Down load the Linux® OS ISO images from the ap- 
propriate distributor’s site. 

See p. 2 for the address. 


© Recording the CD 

Records the down loaded ISO image into the CD. 
The ISO image is the same format as the recorded in 
a CD. When this ISO image is recorded in CD as a 
file, OS cannot be installed with the CD. 


Y NOTE: See the instruction manual of the CD writ- 
ZG ing software about a detailed operation, the ISO 
Z image recording procedures, etc. 


Vv 
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@ Linux® OS installation 


Refer to the appropriate distributor's home page about After the installation, update the OS. 
the details of the OS installation. Any support from RedHat has already been finished, 
See the addresses listed below for your information. however, the update package is supplied from Fedora 


legacy Project. 


’ For your information (*The following addresses may delete or change without notice.) 


¢Fedora Core 2 
http://fedoraproject.org/ 
http://fedora.redhat.com/ 
¢RedHat® Linux® 9 
-OS down load site 
http://ftp.redhat.com/pub/rechat/linux/9/en/iso/i386/ 
-ISO images necessary 
shrike-i386-disc1.iso, shrike-i386-disc2.iso, shrike-i386-disc3.iso 
- Installation description 
http://www.redhat.com/docs/manuals/linux/RHL-9-Manual 
eFedora Legacy Project 
http://Awww.fedoralegacy.org/ 


@ DNS name server installation 


Install the DNS name server if not installed. 


@ Open “Add/Remove Applications” with the follow- (3) Click “>” mark beside “Extra Packages’ then click 
ing mouse operation. to apply check mark, “,” at “caching-nameserver.” 
Click [x Close] after the setting. 
Fg Picternces 1S sewverSetinas + 
Geese | — (3) Click Ele elineesiep pene wel 
2\ Sound & Video my Autnentication Hl package group is installed. &% 
= VA NE 2 Select Select the extra packages to be installed: 
PE System Tools =} (4 pisplay > Standard Packages 
a isl a Keyboard xtra Packages 
s Home Folder Q ferme ¥) caching-nameserver - The configuration files for setting up a caching name server. 
Network Servers F 5; f ‘i 
Teac 2| Click to add “W. 
€3} Run Program... | @> Mouse : 
(Ql Search for Files... ist) Network 1| Click 
[£57 Open Recent 3 Printing 
Q Lockescreen ie) Root Password 
Bel Log Out | oF Security Level 
Aa (~<% | we Soundcard Detection kl, [ Package Information 
= 7 ) | BS PES anu Groups ps 1 Click Full Name: None 
_ Size: None 
@ Click “DNS name Server” to add a check mark, 3] Click |= aoe 
“Y,” and then click “Details.” L = 
Rad Package Management @ Click [Update] to start the installation. 
Add or Remove Packages 6 ad Package Management lad 
{@_, This package group allows you to share files between Linux a Add or Remove Packages 6) 
Be and MS Windows(tm) systems. 
'/| DNS Name Server 22] Details (gl) This package group allows you to share files between Linux a 
This package group allows you to run a DNS name server and MS Windows(tm) systems. 
(BIND) on the system. | DNS Name Server [2/2] Details 
FTP Server [o/1] This package group allows you to run a DNS name server 
~ — 12 eind)ootnesseta OO 
Click to add “vv.” Click Total install size: 1,947 Megabytes Click 
BI auit Update 
L Q 


SYSTEM SETUP 2 


a Gateway server connections 
© Connecting to the ID-RP1 system 


ID-RP1D (Zone repeater) 


Pugh | 
\ 
\ 
\ 


=! 
ys 


\ Ce 


SB 
Router g 
A to ethO 
Coupler 
i 
© Connecting to the ID-RP2 system 
ID-RP2 (Zone repeater) 
D-star 
oV¥ Cc 6 Litera a () je 
CA QA° 
D-star 
to Internet «— Modem oV Ee 6 iar 
LAN card: ethO : | G- Aee pane (Cie Cie ies | i 
LAN card: eth1 
Router to [10BASE-T] 
A 
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@ Router settings 


© IP address setting 
Set the specified IP addresses for both WAN and LAN 
as follows. 


IP address (WAN) : Enter the fixed global IP address 
that is specified from the ISP. 
IP address (LAN) _: 10.0.0.1 


4% NOTE: The same IP address (for LAN; 10.0.0.1) is used 
Y for all gateways. NEVER use other private IP address. 


@ Sever settings 


© LAN card settings 


© Port forwarding setting 


Set the following port number with protocol to transfer- 
ring to the IP address “10.0.0.2.” 


Bo Usage File location 

P0005/TCP [aon | vtedipve con) 
40000/UDP | Voice transfer eee 
40001/TCP | Data transfer ee 


NOTE: IP filter must be set to allowing Internet re- 
GY mote access to local IP address “10.0.0.2.” 

Y Otherwise the D-STAR gateway will not work due to 
ZY the firewall. 


MS 


gy NOTE: The fixed value for both the IP address and 
G subnet mask must be set to both ethO and eth1. 

Y Otherwise the gateway server cannot communicate 
ZY to another D-STAR gateway. 


@ Open “Network Configuration” screen with the fol- 
lowing mouse operation. 


ideo 


Ts VEO Kuthenticaion Ts VEO Kuthenticaion 
¥ 
A\aeeee Z| Select 
3 System Tools ig Display 
‘6,] Help @ Keyboard 
ir Home Folder 3 Language 
1S Network Servers a Login Screen 
> Run Program... > Mouse 
iQ [Q] Search for Files... L a Network t—————| 3] Click 
(5 Open Recent ®) Printing 
Q ieekscreen \9 Root Password 
ie 
De | Log Out a} Security Level 
Soundcard Detection ro 
@2aea T] Click 
ey ~\Y S| WB Users ana Groups 


(2) Select [ethO] or [eth1] to select router or repeater 
side respectively, then click [Edit]. 
¢The “Ethernet Device" : screen appears as right above. 
7] Network Configuration Viddddddda TD 
File Profile Help 


S//\H_ @- eo -& 


: Click 
Edit / Copy Delete Activate Deactivate 

Devices | Hardware DNS | Hosts | 

=.) You may configure network devices associated with 

4 (=) physical hardware here. Multiple logical devices can be 

» associated with a single piece of hardware. 

[Profile| Status [Device |lNickname [Type -—For router 
(| —s. Active f= -ethO etho Ethernet ead 

MS Active Getht ethi Ethernet <— For repeater 


(3) Select [Statically set IP address], then enter the 
specified IP address, subnet mask and default 
gateway (router side; ethO setting only), as below. 
Click [OK], then close “Ethernet Device” screen. 


bd Ethernet Device x 


General | Route | Hardware Device 


Displays the LAN card name 
that is selected in steps @. 


Nickname:  eth1 <«—\__ 


[¥] Activate device when computer 


Allow all users to enable and disable the device | 


© Automatically obtain IP address settings with: etho: 255.0.0.0 
eth1: 255.255.255.0 
optional) I 
ethO: 10.0.0.2 
@ Statically set IP addres; Select eth1: 172.16.0.20 


Manual IP Address Settings | 


DHCP Settings 


Hostnar 


(¥] Automatically obtain DNS information from 


Address: 172.16.0.20 = ————___—____! 


Subnet Mask: 255.255.255.0 ~€ 


| 


Default Gateway Address: 
ethO: 10.0.0.1 
Click @ OK eth1: Blank 
L. = 


() Click [DNS] tub in “Network Configuration” screen, 
then enter the address “127.0.0.1” (fixed value) 
into “Primary DNS” column. 


fad Network Configuration 


File Profile Help 


vee 


New Edit C 


Devices | Hardwari DNs | ‘Click 


You may configure the system's hostname, domain, 
name servers, and search domain. Name servers are 
used to look up other hosts on the network. 


Primary DNS: 


127.0.0.1 ~«———_] 127.0.0.1 


Hostname: localhost.localdomain 


Primary DNS: 


Ss ee 


© Named setting 


SYSTEM SETUP 


2 


WW@ 


setting. 


Y \MPORTANT!: Master the basis of BIND with a ref- 
erence book of Linux, before starting the named 


@ Add local zone setting file (dstar.local.) to 


“letc/named.conf.” 


°e.g.; /etc/named.conf 


(3) Open “Service Configuration” screen with the fol- 
lowing mouse operation. 


ce Preferences 


& Programming 
OD sound & Video 


I 5 Server Settings 


4 0) Add/Rem|3ve Application: 
5 Authentication 


| B®: system Settings 


[ Date & T 


eae Syster 


1ools 


1 a Display 


me 


bg named. COMA - (Fx 
File Edit View Go Bookmarks Help 
dq. P .40%,/f 
Back Forward Up Stop Reload Home 


Location: | /etc/named.conf View as Text * 


r 
file "named.local"; 
allow-update { none; }; 


}; 


// for D-STAR 

zone "dstar.local" IN { 
type master; 
file "dstar.local.db"; 
allow-update { none; }; 


Add 


}; 


include "/etc/rndc.key"; 


¥ 


l “named.conf" selected (853 bytes) ] 


(2) Create database, /var/named/dstar.local.db, for 
local D-STAR as the following example. 
% NOTE: A full-stop period must be applied into 
2nd, 3rd and 10th lines. And set the separator 
as below at the end of the line. 

;##DSTAR A RECORD 


WAN 


°e.g.; /var/named/dstar.local.db 


b.4_dstar.local.db = F 
File Edit Help 


d@.P .40 %)\8 


Back Forward Up Stop Reload Home 


View Go Bookmarks 


Location: /var/named/dstar.local.db 


View as Text * | | 


6.) Help 


CS vauhnard 


rr Home Folder 
15% Network Servers 


£3) Run Program... 


Search for Files... 


a) Open Recent 


Q Lock Screen 


SSF Log out 


Q Language 
| & Login Screen 
| > Mouse 
E,4 Network 
3 &) Printing 
@ Root Password 
Bie Security Level 


a 


—-—. |'5) Soundcard Detecti 
VAG A 18 oundcan ection 
& SS X< <&)) EE Users ana Groups 


-[1] Click 


2 


@) Click the check box beside “named,” then save the 
changed setting if no check mark, “,” is added. 


ervice Configuration 


i} 


Click 


Refresh Service List Ctrl+R 


® Save Changes Ctrl+S 


3] Click to save 
fiting Runluva. » 


~y Revert rOLast Save CUFL 


Ctrl+Q 


quit 
D irda 
isdn 
| keytable 


kudzu 


Description 
named (BIND) is a Domain Name Server (DNS) that 
|s used to resolve host names to IP addresses. 


Status 
number of zones: 5 


=| netfs 


= 


[1] Click to add check mark, “”” 


(©) Select “named” item, then click [Restart] to restart 


$TTL 86400 Full stop period . j 
SORIGIN dstar.local.” Full stop period the named setting. 
? 1D'IN gm acer a a Ad Service Configuration -(/B\x 

9 . refresh File Actions Edit Runlevel Help 

15M ; retry 

1wW } expiry > e & 2 Click 

1D) > minimum Start Stop \ Restart 

Currently Running inv=evel: 5 Editing Runlevel: 5 
IDINNS dstar.local. ~——____ Fy stop period TO bescteee [4] Description 
named (BIN ime Server (DNS) 
router INA 10.0.0.1 named mars use LL} Select imes to iP addresses. 
gw INA 10.0.0.2 Lo wees 
- twork [ 


\## DSTAR A RECORD <————— Separator 


"“dstar.local.db" selected (265 bytes) 


Y 
Ww 
is 


For your information 
hen “Fedora Core 2” is used, the database location 
“Wvar/named/chroot/var/named/dstar.local.db.” 
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© DNS function verification 


@® Start up “Terminal” with the following mouse oper- 
ation. 


3; * {C) Floppy Formatter 
£3 system Settinas 4 
£ Hardware Browser 


l\c eaters ncmenhcaeeeeed 

ZN. System Tools [qi Intemet Conniguration wizara 2| Select 
gore fe Kickstart 

r Home Folder ©, Network Device Control 

(5 Network Servers 


< Printing Notification Icon 
> Run Program... 
Search for Files... & Red Hat Network 
[| Open Recent = 


§# Print Manager 


9 Gy Red Hat Network Alert icon 1] Click 
é } Lock Screen = SVS SE 3] Click 
{@| Svstem Molitor 
| ] Log Out 


@9e4 


5) FW Traceroute | 


@ The local DNS operation can be verified by enter- 
ing the following command. 
# dig router.dstar.local 


(3) When the correct router IP address “10.0.0.1” is 
displayed in the answer section as below, the GW 
setup is succeeded. 


bd root®localhost:~ - Ax 

File Edit View Terminal Go Help 

[root@localhost root]# dig router.dstar.local [a] 
LT EO 


3 <<>> DIG 9.2.1 <<>> router.dstar.local 
33 global options: printcmd 

3; Got answer: 

}} ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 62985 

3; flags: qr aa rd ra; QUERY: 1, ANSWER: 1, AUTHORITY: 1, ADDITIONAL: 0 


Enter the command 


;; QUESTION SECTION: 
;router.dstar.local. IN 


Router IP address 


33 ANSWER SECTION: 
router.dstar.local. 86400 IN A 10.0.0.1 
Vn 


;; AUTHORITY SECTION: 

dstar.local. 86400 IN NS dstar. local. 
33 Query time: 19 msec 

33 SERVER: 127.0.0.1#53(127.0.0.1) 

33 WHEN: Mon Mar 14 12:54:13 2005 

33 MSG SIZE revd: 66 


[zectelocalhost root ]# | ca) 


@ Gateway control software 
> Installation 


@ Insert the RS-RP2C CD into the drive. 

(2) Expands the file into the “/dstar” directory using 
with the following command, or double-click the file 
during the CD content is displayed. 

Command: # tar zxvf dstar-xxxx.tar.gz 
(XXXX=revision number) 


© Syslog setting 


(3) Copy the both “dsgwd.conf” and “dsipsvd.conf” 
files, expanded in the “/dstar/conf” directory, into 
the “/etc” directory. 

(4) Open the copied files, then edit the contents to 
suits the network. 
¢See page 8 and 9 for details. 


Z For your convenience: 

Set the syslog if desired. 

By setting the syslog, easy log management is pro- 
vided because of the independent log. 


WMAQ@iW 


» Add the following contents in “etc/syslog.conf.” 
# for D-STAR 
localo.* 
local2.* 


/var/log/dsgwd.log 
/var/log/dsipsvd.log 


© Starting up the control software 


Execute script “/dstar/exec-mgsv” when starting up 
the gateway control software. 


When starting up the control software and the system 
at the same time, add the command as above in the 
“/etc/rc.d/rc.local.” 


And we recommend to set the server condition as de- 
scribed at right above to improve the gateway server 
performance. 


¢ Deactivate all the services except below 
anacron, apmd, atd, crond, keytable, named, 
network, ntpd, random, sshd, syslog, xinetd 


¢Do not start up the X-Window System when 
starting up the gateway server 
Change the “Default runlevel” in “/etc/inittab” from 
5 to 3. 
*The X-Window System start up manually with the 
“startx” command. 


© Data base directory 


SYSTEM SETUP 


2 


Make the directory for data base backup in the “/var.” 
“/var/dsipsvd” is specified as the default setting. 


*Refer to @ BACKUPDIR_PATH (p. 9) 


lm System setup 
© Setup example 


Gateway server 
(TRUST SERVER) 


Gateway server 

IP address 

ethO (for router) :10.0.0.2 
eth1 (for repeater) : 172.16.0.20 


py 


o 


Zone repeater 
[6] IP address: 172.16.0.1 


[6 | 


| PortNo. | Protocol 
IP address ; F 
2) LAN: 10.0.0.1 Voice Receive | 40000 | UDP 
3] WAN: The fixed IP address |DataReceive | 40001__| TCP 
specified by the ISP |Data sync. | 20005 | TCP 
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@ Control software settings 
© dsgwd.conf screen description 


v g -FA x 
File Edit View Go Bookmarks Help 
dq. >? .40%,f O 
Back Forward Up Stop Reload Home 


Location: | /etc/dsgwd.conf View as Text * 


it 
# dsgwd.conf 

# Configuration file for D-STAR GW-Server(type2) Daemon 
# (C) 2004-2005 Icom Inc. Revision 1.0 

# 


# Zone Repeater's Information 


ZR_ADDR=172.16.0.1 <——______@} 
ZR_CALLSIGN=RPT000 << 


ZR_PORT=20000 


# DNS Server's Information 
DNS_ADDR=10.0.0.1 


DNS_MAC=00-90-C7-3B-0C-CB << 


# GW's Information 


GW_ETHIFNAME=etho <———____@ 
GW_VCPORT-40000 <<) 


GW_DTPORT=40001 


GW_ZRPORT=20000 ~——_________—-@) 


# IP Server's Information 


MGSV_QRPORT=12345 <<) 


Peay arO aes ae | |) 


# GW connection 
CON_WAIT_INTERVAL=2 


CON_REFRESH_INTERVAL=300 <4) 
CON_MAX_GW=50 <——__¢) 


[Lcdsawe.cont” selected (525 bytes) 7A | 


— Zone Repeater’s Information — 
@ ZR_ADDR 

Sets the zone repeater’s IP address (the IP address 
6| in © Setup Example). 


The same IP address that is programmed in “IP” (for 
the ID-RP1D maintenance) or “IP Address” (for the util- 
ity for ID-RP2C) cell in “Communication Settings” 
should be set. 


@ ZR_CALLSIGN 
Sets the zone repeater’s call sign. 
The same call sign that is programmed in “Callsign” 


cell in “General” of the ID-RP1D maintenance or the 
utility for ID-RP2C should be set. 


© ZR_PORT 
Sets the zone repeater’s transmit/receive port num- 
ber (the port number [6] in © Setup Example). 
The same port number that is programmed in “Port” 
cell in “Communication Settings” of the ID-RP1D 
maintenance or the utility for ID-RP2C should be set. 


— DNS Server’s Information — 

@ DNS_ADDR 
Sets the zone DNS server’s IP address (the IP ad- 
dress |3| in © Setup Example). 


© DNS_MAC 
Sets the zone DNS server’s MAC address (the MAC 
address |3] in © Setup Example). 
Set the MAC address of the connected router with 
dividing by hyphen (-). 


— GW’s Information — 

@ GW_ETHIFNAME 
Sets the interface name of the LAN card (the inter- 
face name |4] in © Setup Example). 


The interface name can be confirmed with the “if- 
config” command. 


@ GW_VCPORT 
Sets the port number for voice operation (UDP). 
Use the default setting. 


© GW_DTPORT 
Sets the port number for data operation (TCP). 
Use the default setting. 


© GW_ZRPORT 
Sets the port number of the gateway server self for 
the communication with the zone repeater (UDP). 
Use the default setting. 


— IP Server’s Information — 

@ MGSV_QRPORT 
Sets the port number of the IP address managing 
server for call sign inquiry (UDP). 
Use the default setting. 


@ MGSV_UDPORT 
Sets the port number of the IP address managing 
server for updated location information request 
(UDP). 
Use the default setting. 


— GW connection — 
@® CON_WAIT_INTERVAL 
Sets the application timer. 


The application timer is the waiting timer (unit: sec- 
ond) until the connection is succeeded when mak- 
ing a new connection to another gateway in data 
mode operation. 


Use the default setting. 


@® CON_REFRESH_INTERVAL 
Sets the decide timer (unit: second) to impossible to 
connect to the gateway which is failed in connection 
once in data mode operation. 
Use the default setting. 


@® CON_MAX_GW 
Sets the maximum number of simultaneous con- 
nections to another gateway in data mode opera- 
tion. 
Use the default setting. 


© dsipsvd.conf screen description 


a4 dsipsvd.conf, -=Ax 
File Edit View Go Bookmarks Help 


da. PpPl.,aQ% A QO 


Back Forward Up Stop Reload Home 


Location: /etc/dsipsvd.conf View as Text * 


# 
# dsipsvd.conf 

# Configuration file for D-STAR IP-Server Daemon 
# (C) 2004-2005 Icom Inc. Revision 1.0 

# 


# Communication Port Number 
PORT_SEARCH=12345 ~< 
PORT_RENEWAL=12346 ~< Q 


# Command In/Out Mode (0:FIFO / 1:stdin,stdout) 
CMDMODE_STD=0 ~<€ 


# Backup Param. 
FILE_SWEEP_HOLD - 86400 <—_________@} 
FILE_SWEEP_CHECK = 3600 


BACKUPDIR_PATH = /var/dsipsvd <——_______@ 8 
# IP Server comm. Info. 


TRUST_SERVER = 
PORT_SYNC = 20005 ~« © 


SEND_RECV_TIMEOUT = 10 <—_________ 


# My IP Server Info. 


ZR_CALLSIGN=RPT000 <<) 
= ® 


IPSV_ADDR = 
DNS_ZONE_FILE_PATH = /vat/named/dstar.local.db <—Q 


# Named Pid File Name 


NAMED_PID_FILE = /var/run/named/named.pid <«——_® 


[Lccsipsva.cont” selected (635 bytes) V/A} 


— Communication Port Number — 

@ PORT_SEARCH 
Sets the port number of the IP address managing 
server for call sign inquiry (UDP). 
Use the default setting. 


@ PORT_RENEWAL 
Sets the port number of the IP address managing 
server for updated location information request 
(UDP). 
Use the default setting. 


— Command In/Out Mode — 

© CMDMODE_STD 
Sets the command processing mode. 
Use the default setting. 


— Backup Param. — 

@ FILE_LSWEEP_HOLD 
Sets the backup file preservation period (unit: sec- 
ond). (default: 86400 sec.) 


© FILE_SWEEP_CHECK 
Sets the backup file check interval for the file delet- 
ing (unit: second). (default: 3600 sec.) 


© BACKUPDIR_PATH 
Sets the directory for saving the backup file. 
The directory “/var/dsipsvd” is the default. 


SYSTEMSETUP 2 


— IP Server comm. Info.— 

@ TRUST_SERVER 
Sets the IP address of the “TRUST SERVER’ to ac- 
quire the user information in MNG, GIP and RIP 
table when starting up the repeater first time. 


© PORT_SYNC 
Sets the port number for the user information in 
MNG, GIP and RIP table synchronization. (TCP) 
Use the default setting. 


© SEND_RECV_TIMEOUT 
Sets the time-out period for the user information in 
MNG, GIP and RIP table synchronization. 
Use the default setting. 


— My IP Server Info. — 

@ ZR_CALLSIGN 
Sets the call sign of the zone repeater. 
The same call sign that is programmed in 
“ZR_CALLSIGN?” in “dsgwd.conf” file should be set. 


@ IPSV_ADDR 
Sets the fixed IP address (global address) of the IP 
server (the IP address |2] in © Setup example). 


@® DNS_ZONE_FILE_PATH 
Specifies the DNS zone file for D-STAR. 


— Named Pid File Name — 
@® NAMED_PID_FILE 
Sets the PID (Process ID) of the named setting. 


2 SYSTEM SETUP 


@ IP server operation 
© Command operation 


Sets the command input and output using with the 
“FIFO” (/tmp/dsipsvd-cmdin, /tmp/dsipsvd-cmdout). 
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root®localhost:/tmp, 


File Edit View Terminal 


Go Help 


[root@localhost tmp]# ls /tmp/dsipsvd* 


[root@localhost tmp]# 


@ Start up 2 Terminals, Terminal-1 and Terminal-2 
with the following mouse operation. 


a * {E) Floppy Formatter 
J23 svstem Settinas 4 
£, Hardware Browser 


©) Intemet Contiguration wizard 2| Select 
wo bus] Ff Kickstart 

@ ao © 4 Network Device Control 

Ue edencere arb ee & Printing Notification Icon 

2) Run Program... xs Print Manager 

Search for Files... & Red Hat Network 

G yyvpen Recent , =r Malt WELWUIK AIEIL PCUTT 1 Click 

3] Click 


®@ system Loc= 

g ] Log Out r-] Svstem Mo|itor 

——x 
o AY 

(S92 Na 5) BR Traceroute [ 


@ Enter the following command in the Terminal-1 to 
make an output terminal of the “FIFO.” 
#cat /tmp/dsipsvd-cmdout 


v 


root®localhost:/tmp, 


File Edit View Terminal Go Help 


[root@localhost tmp]# cat /tmp/dsipsvd-cmdout ~~ Command 
—™__"’'~——=~=er._[V—"—_—— 


¢Format 
Mark Description 
A Space (ASCII code: 0x20) 
| Vertical line (ASCII code: 0x7c) 
[CS(T/A/Z)] | 8-character call sign (T: Target, A: Area repeater, Z: Zone repeater) 
When the entered call sign does not fulfil 8-character, fill using a space. (ASCII code: 0x20) 
[DB] Enter one of “GIP,” “RIP” or “MNG.” (Capital letters only) 
[GWIP] Enter the global IP address of the gateway divided by full stop (.). 
[TIP] Enter the local IP address of the target server divided by full stop (.). 
[HNAME] Enter the target HOST name that is used for DNS. 
Usable characters: A-Z, a-z, 0-9, _,/, [, ], + 
[FNAME] Enter the file name that is specified by the absolute path. 
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Local IP address reservation 


SYSTEMSETUP 2 


© Enter the following command in the Terminal-2. 
#echo “reserve”>/tmp/dsipsvd-cmdin 
¢The command processing result outputs to Terminal-1. 


bd foot@Iocalhost:/tmp 
File Edit 


View Terminal Go 


Help 


[root@localhost tmp]# echo "reserve" > /tmp/dsipsvd-cmdin 
[root@localhost tmp]# i 


Command 


(2) The reserved IP addresses are displayed when the 
“reserve” command operation is succeeded. 
¢32 of local IP addresses are reserved in consecutive 
numbers. 


lied P00 localhost:/tmp 
File Edit View Terminal Go 


Help 


[root@localhost tmp]# cat /tmp/dsipsvd-cmdout 
ADDRESS=10.22.179.96 - 10.22.179.127 

END 

200 Command OK 


(2 Reserved IP addresses 


¢ Station registration 


> Enter the following command in the Terminal-2. 
#echo“add ID1000|RPTO00|RPTOOO | 
XXX. XXX .XXX.XKX | 10.22.179.96 | 1d1000” 
> /tmp/dsipsvd-cmdin 
*XXX.XXX.XXX.XXX=global IP address 
Format: 
addA[CS(T)]I[CS(A)]I[CS(Z)]|[GWIP]I[TIP]| 
[HNAME] 
eLocal IP addresses must be reserved using with “re- 
serve” command in advance. 
¢The command processing result outputs to Terminal-1. 
- Ax 


bd foot@localhost:/tmp 
File Edit 


View Terminal Go Help 


IE 


[root@localhost tmp]# echo "reserve" > /tmp/dsipsvd-cmdin 
[root@localhost tmp]# echo "add ID1000 |RPTOOO |RPTOOO | 


|10.22.179.96|id1000" > /tmp/dsipsvd-cmdin 


[root@localhost tmp]# 


—_____ 


Command (example only) 


<The station registration confirmation> 
» Enter the following command in the Terminal-2. 
#dig id1000.dstar.local 
¢The registration is succeeded when the registered local 
IP address is displayed in answer section. 


bg root localhost:/tmp. -= AX 
File Edit View Terminal Go Help 


[root@localhost tmp]# dig id1000.dstar.local ~—_ Command 
a ll 


3 <<>> DIG 9.2.1 <<>> id1000.dstar. local 

+; global options: printcmd 

;; Got answer: 

33} ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 27891 

3; flags: qr aa rd ra; QUERY: 1, ANSWER: 1, AUTHORITY: 1, ADDITIONAL: 0 


Confirmed staion 
IP address 


+} QUESTION SECTION: 
}id1000.dstar.local. IN A 


3; ANSWER SECTION: 


id1000.dstar.local. 86400 IN A 10.22.179.96 
SS ~. 
3; AUTHORITY SECTION: 


ocal. NS 


he 


¢ Station data synchronization 


=» Enter the following command in the Terminal-2. 
#echo “push_mng”> /tmp/dsipsvd-cmdin 
¢The registered station information will be registered to 
another gateway’s IP server when this command is per- 
formed. 


© Data output 


» Enter the following command in the Terminal-2. 
#echo “write MNG /tmp/mng.txt”> 
/tmp/dsipsvd-cmdin 
Format: 
writeA[DBJA[FNAME] 
¢The functioning data in the memory is output into the 

specified file. 
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2 SYSTEM SETUP 


¢ Deleting a station registration 


» Enter the following command in the Terminal-2. 
#echo “del ID1000”> /tmp/dsipsvd- 


NOTE: A delete flag is applied to the deleted station 
data in the MNG. (The record is not deleted, the 


cmdin delete flag “1” is added only.) 
Format: The deleted call sign is usable when “add” 
delA[CS(T)] command is used. 

© Backup file 


A backup file is made with the following file name and 
contents into the directory that is specified in “BACK- 
UPDIR_PATH’” in IP server’s parameter. 

The latest file is re-loaded when re-starting the pro- 
gram. 


(YYYY: Year), (MM: Month), (DD: Day), 
(HH: Hour), (mm: Minutes), (ss: Second), 
(uuuuUU: micro second) 


¢Global IP address table 
(gip_YYYYMMDD_HHmmss_uuuuuu.dat) 
File contents: 
[GWIP][tab]Registered time[tab]Communication 
permission[tab]Effective flag 


¢ Target information table 
(mng_YYYYMMDD_HHmmss_uuuuuu.dat) 
File contents: 
[GWIP][tab][CS(Z)][CS(A)][tab][CS(T)][tab] 
[HNAME][tab][TIP][tab]Registered time[tab]Delete 
flag[tab]CommandExec. Time 


¢Reserved IP address table 
(rip_YYYYMMDD_HHmmss_uuuuuu.dat) 
File contents: 
[Reserved head IP address]|tab][GWIP][tab]Reg- 
istered time[tab]Effective flag 


© Data base maintenance 


The maintained data will be restored when the gate- 
way server synchronized with another gateway even 
if the data has been deleted because of the IP servers 
are synchronized each other. 

Follow the maintenance instructions as at right. 


@ Read out the “TRUST SERVER” data with the 
“write” command. 
¢Used the same format for the file name as the “Backup 

file” as described above. 

(@ Deactivate the all programs that are connected to 
the gateway server. 

(3) Evacuate the all files in the backup directory in the 
connected gateway server into the desired loca- 
tion. 

@ Move the file that is read out at step @ into the 
backup directory. 

©) Edit the file using a editor application. 

© Start up the “TRUST_SERVER.” 

@ Start up another gateway servers one by one to 
read the “TRUST_SERVER’ data. 


gy NOTE: When starting up the server with brand- 
% new condition, start up the server with the con- 
Z dition that the backup directory is emptied. 
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SOFTWARE UNINSTALLATION 3 


#@ Uninstallation 


Refer to the following instructions when uninstalling the 
software. 


@ Delete the following directories. 
e/dstar 
e/var/dsipsvd 

(2) Delete the following files. 
e/etc/dsgwd.conf 
e/etc/dsipsvd.conf 
e/var/named/dstar.local.db 
e/var/log/dsgwd.log 
e/var/log/dsipsvd.log 
e/tmp/dsipsvd-cmdin 
e/tmp/dsipsvd-cmdout 

@) Restore the following files. 
e/etc/named. conf 
e/etc/syslog.conf 
e/etc/re.d/re.local 
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